Skip to content

feat: Add online installer and auto-config for autoHandoff #6

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Open
jellydn wants to merge 12 commits into
base: main
Choose a base branch
from
Open

feat: Add online installer and auto-config for autoHandoff #6

jellydn wants to merge 12 commits into from
+435 −11

Conversation

@jellydn
Copy link

@jellydn jellydn commented Jan 10, 2026 •
edited
Loading

What

This PR introduces an online installer script to simplify the setup of Ralph. It also enables the installer to automatically configure the recommended setting for users.

Why

  • To make it easier and faster for users to start using Ralph.
  • To ensure that the feature is enabled by default, improving the out-of-the-box experience.
  • To allow users to easily install the PRD and Ralph skills globally.
  • Support for both Amp and Claude Code AI coding tools.

How

Install from release (recommended)

# For Amp (default)
curl -sSL https://github.com/snarktank/ralph/releases/latest/download/install-from-release.sh | bash

# For Claude Code
curl -sSL https://github.com/snarktank/ralph/releases/latest/download/install-from-release.sh | bash -s -- --tool claude

# Or download and inspect first (security best practice)
curl -O https://github.com/snarktank/ralph/releases/latest/download/install-from-release.sh
less install-from-release.sh  # inspect the script
bash install-from-release.sh

# Install specific version
curl -sSL https://github.com/snarktank/ralph/releases/download/v1.0.0/install-from-release.sh | bash -s 1.0.0

Install from main branch (for testing)

# For Amp
curl -sSL https://raw.githubusercontent.com/snarktank/ralph/main/install.sh | bash

# For Claude Code
curl -sSL https://raw.githubusercontent.com/snarktank/ralph/main/install.sh | bash -s -- --tool claude

Verification Steps

  1. Verify that the scripts/ralph directory is created with ralph.sh and prompt file (prompt.md for Amp, CLAUDE.md for Claude Code).
  2. Check that scripts/ralph/ralph.sh is executable.
  3. For Amp: Verify that your ~/.config/amp/settings.json file now includes the amp.experimental.autoHandoff setting.
  4. Verify skills are installed globally (~/.config/amp/skills/ or ~/.claude/skills/).

@jellydn @claude
feat: add online installer and auto-config for autoHandoff
2cecc73 
Adds an install.sh script for easy installation with curl. The script also automatically configures the recommended amp.experimental.autoHandoff setting in the user's ~/.config/amp/settings.json file.

Co-Authored-By: Claude <noreply@anthropic.com>
@jellydn jellydn marked this pull request as ready for review January 10, 2026 13:56
@jellydn jellydn changed the title feat: Add online installer feat: Add online installer and auto-config for autoHandoff Jan 10, 2026
@jellydn jellydn force-pushed the feature/online-installer branch from af64da3 to 45d8cd1 Compare January 10, 2026 14:40
@snarktank
Copy link
Owner

snarktank commented Jan 11, 2026

Thanks @jellydn - can you share a video of you using this and verifying it works?

@jellydn
Copy link
Author

jellydn commented Jan 11, 2026

@snarktank Sure, here you are: https://s.itman.fyi/G0bNBgJJ

@snarktank
Copy link
Owner

snarktank commented Jan 12, 2026

Hey, thanks so much for putting this together! Really appreciate you taking the time to contribute.

I love the idea of making installation easier, but I have some security concerns with the curl | bash pattern that I'm not comfortable shipping:

  • If the repo were ever compromised, everyone installing would automatically run malicious code
  • No way for users to verify the script before it modifies their system
  • Pulling from main means untested changes could go out immediately

These are industry-wide concerns with this pattern, not anything specific to your implementation.

Would you be open to reworking this to either:

  1. Provide a download-then-run approach with checksums, or
  2. Use versioned releases instead of main?

Totally understand if you don't have time for that - just wanted to explain why I can't merge as-is. Thanks again for trying to improve the repo.

@jellydn
Copy link
Author

jellydn commented Jan 12, 2026

Hi, I see your point and here is the plan Are you okay with this approach? Thanks.

@jellydn
Copy link
Author

jellydn commented Jan 13, 2026

FYI - Tested on https://github.com/jellydn/ralph/releases/tag/v1.0.0-beta.1

@snarktank
Copy link
Owner

snarktank commented Jan 16, 2026

Thanks for putting together this plan and testing it! This looks good to me.

One small request before I merge: can you add a download-verify-run option to the README alongside the curl | bash? Something like:

# Or download and inspect first
curl -O https://github.com/snarktank/ralph/releases/latest/download/install-from-release.sh
less install-from-release.sh  # inspect
bash install-from-release.sh

That way users who want to verify before running have a clear path. Once that's in, I'll merge.

@jellydn
docs: add installation instructions from release
a2dfb32 
Add installation section to README with options to:
- Quick install from latest release via curl pipe
- Download and inspect script before running for security
- Install specific version by setting VERSION environment variable

This provides users with flexible installation methods and follows security best practices by offering script inspection option.
@jellydn
Copy link
Author

jellydn commented Jan 16, 2026

Sure @snarktank No problem, thanks.

jellydn and others added 2 commits January 22, 2026 22:42
@jellydn
Merge branch 'main' into feature/online-installer
67f7872
@jellydn
feat: Add --tool flag to installers for Claude Code support
5d52021 
- Add --tool amp|claude flag to both install scripts
- Install prompt.md for Amp, CLAUDE.md for Claude Code
- Install skills to ~/.config/amp/skills or ~/.claude/skills
- Skip Amp auto-handoff config when using Claude Code

🤖 Generated with [Claude Code](https://claude.com/claude-code)
@jellydn
Copy link
Author

jellydn commented Jan 22, 2026

Thanks for the feedback! I've added a download-verify-run option to the README and expanded the installer to support Claude Code as well.

Changes Made

Installers now support --tool amp|claude flag:

  • Amp (default): Installs prompt.md and configures ~/.config/amp/settings.json
  • Claude Code: Installs CLAUDE.md and configures ~/.claude/skills/

Usage:

# For Amp (default)
curl -sSL https://github.com/snarktank/ralph/releases/latest/download/install-from-release.sh | bash

# For Claude Code
curl -sSL https://github.com/snarktank/ralph/releases/latest/download/install-from-release.sh | bash -s -- --tool claude

# Or download and inspect first
curl -O https://github.com/snarktank/ralph/releases/latest/download/install-from-release.sh
less install-from-release.sh
bash install-from-release.sh --tool claude

The --tool flag also works with install.sh for testing from main branch.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@jellydn @snarktank